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This thesis describes the design and implementation of 
a high level/ general purpose/ interactive graphics 
subroutine library for the Vector General Interactive Graph- 
ics Display System. The lower interface levels of the sys- 
tem and its effects on the development of this high level 
interface are discussed. The problems and various 
approaches associated with the development of a general pur- 
pose/ high level applications subroutine library that is 
user oriented is outlined. The basic design goals/ solu- 
tions and recommendations for further expansion of the sys- 
tem are presented. This Graphics subroutine library is 
implemented within the conventions of the C-Programmi nq 
language and the UNIX operating system as implemented on the 
PDP-ll/50 in the Naval Postgraduate School Computer Labora- 
tory. 
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I. INTRODUCTION 



This thesis discusses the design and implementation of 
a high levels general purpose graphics subroutine library 
for an interactive graphics display system. The subroutine 
library -was designed to support the Vector General Interac- 
tive Display System (Vector General) (1)/ as installed at 
the Naval Postgraduate School Computer Laboratory. 

The Vector General represents a highly sophisticated 
graphics display terminal with hardware implemented three 
dimensional rotation^ translation and scaling. An 
alphanumeric keyboards lighted function switches/ control 
dials and light pen provide the interactive tools of the 
system. The Vector General is interfaced with a PDP-11/50 
computer and is suDoorted by the UNIX operating system. 

The actual design and implementation of this high 
level/ general purpose interface is discussed as well as the 
goals and problems encountered during it's development. The 
problems included providing a user with the ability to 
describe and name picture seaments/ designing functions that 
would not limit the capabilities of the machine/ and how to 
effectively utilize the existing interface levels. The main 
goal was the development and implementation of a simple/ 
easy to use/ general purpose graphics subroutine library. 
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A user's manual was written^ describinq the imolemented 
library functions^ so a user can easily utilize the graphic 
capabilities of the Vector General from a program written in 
the high level language/ C [?J . This is included as Appen- 
dix A . 
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II. DESCRIPTION OF THE VECTOR GENERAL 



The Vector General Graphics Display System is an 
interactive graphic cathode ray tube (CRT) display that is 
interfaced with a PDP-ll/50 computer. The display interacts 
with a user by displaying pictorial data» programmaticly 
described by the user# on the surface of the CRT. The sys- 
tem provides both hardware features and external control 
devices that can be utilized by a user to alter and manipu- 
late the pictorial data being displayed. 

A. HARDWARE FEATURES 

The cathode ray tube (CRT) is the most widely used 
graphics display device and the one capable of generating 
and dynamically changing graphical data. The Vector General 
display consists of a CRT and has many supporting hardware 
features (lf31. The hardware features provide^ in addition 
to a vector generator# a circle-arc generator and a charac- 
ter generator. The system also has hardware implemented 
three dimensional rotation# translation and scaling. The 
features are controlled and coordinated by the Vector Gen- 
eral display controller. The controller is also responsible 
for handling communications with the external control dev- 
ices. These external devices include an alphanumeric key- 
board# thirty-two lighted function switches# ten control 
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dialSf and a light pen. Figure 1 is a block diagram of the 
Vector General Display System. 




FIGURE 1 

Vector General Oisolay System 
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III. EXISTING INTERFACE LEVELS 



The existing interface levels for the Vector General 
provide an efficient interface with the PDP-11/50 and a user 
software interface package makes the detailed operations of 
the system transparent to the user, 

A. UNIX AND PDP-11/50 INTERFACE 

The Vector General is interfaced with a PDP-11/50 com- 
puter having 6^K bytes of memory and up to sixteen million 
bytes of disk storage. The interface was designed to be 
used in the mut 1 i programmi ng environment of the UNIX time 
sharing operating system t^l . 

This interface provides the Vector General display pro- 
cessor with access to a 32K block of PDP-11/50 memory. The 
Vector General display data is maintained within this block# 
and is continually accessed through a Direct Memory Access 
(DMA) channel by the Vector General processor in order to 
refresh the display screen. This approach frees the PDP- 
11/50 processor for other tasks# for example executing user 
programs. A detailed description of this interface design 
can be found in the Design Manual for the Vector General 
Display Unit C 51 , 



Perhaps the most important aspect of this interface is 
the resulting support of the Vector General by the UNIX 
operating system. This added dimension provides the graph- 
ics user with all the features of a general-purpose# multi- 
user# interactive operating system in addition to the 
graphic capabilities provided by the Vector General. 

The UNIX operating system is designed to provide a user 
with a system that is simple and easy to use . Within 
this framework extremely powerful features are available to 
the user. These include: a hierarchical file system# a sys- 
tem command language# comoatible file-device and inter- 
process I/O# over 100 subsystems including several languages 
and the ability to initiate asynchronous processes. The 
system's primary high level languages are C and Fortran. 

These features of the UNIX operating system provide an 
efficient and flexible environment for a graphics user. The 
user has the facilities to maintain and manipulate large 
graphical data files. Communications links with devices 
such as tape drives and disks are easily established. The 
command language provides for the creation# reading and 
writing of files and for transferring them between devices. 
An interactive text editor is available for program crea- 
tion# as is an interactive debugger for program debugging. 
These are only a few of the extra facilities that become 
part of the graphic users environment due to this interface 
with UNIX and the POP-11/50. 
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Moving the Vector General from a self supporting stand 
alone graphics environments to one supported by a powerful 
operating system/ greatly extends the resources available to 
the user. This extended system provides an environment for 
the development of a truely general purpose/ high level 
graphics display system, 

B. LOWER LEVEL USER INTERFACE 

The existing user interface software package defines 
high level constructs which the interface routines convert 
to Vector General commands. These constructs define a 
hierarchical picture structure within which a user can iden- 
tify meaningful picture segments. The three construct lev- 
els defined by the softeware interface are: picture/ object 
and e 1 ement 16) . 

1. Picture Structure 

The construct level/ Picture/ refers to all the data 
that is to be displayed on the Vector General display 
screen. An element refers to the smallest picture entity 
that can be independently referenced and changed without 
affecting the remainder of the picture. Each element is 
defined by a series of Vector General display instructions. 
An object represents the lowest construct that can be 
displayed alone. Each object consists of one or more user 
defined elements. An object is independently rotatable/ 
translatable and scalable to any portion of the display 
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screen. The picture defines the oicture scale and screen 
coordinates for all objects. 

• 

The generation and contents of the constructr pic- 
ture and object are the responsibility of the interface 
software. A series of user routines are provided for the 
programmer to establish the desired objects element associa- 
tions. Additional routines are available to dynamically 
modify picture# object and element parameters. 

These three constructs orovide a logical base for 
structuring of pictorial data by a user. It does not# how- 
ever# produce an optimal user interface. The present inter- 
face provides no assistance in the creation of the display 
instructions that describe each element. The user is 
responsible for correctly dimensioning an array for each 
element and for filling it with the correct Vector General 
display instructions. These instructions reaui re the user to 
soecify coordinate values with respect to the screen coordi- 
nate system# and to soecify coordinate registers and the 
desired actionCi.e.# load# draw or move). This process of 
describing elements does not provide a user with a clear# 
simple and unified set of concepts for developing graphic 
disolays. It reguires the user to concentrate on the graph- 
ics device# its registers# coordinate system and capabili- 
ties and not on the picture that is to be created. The pro- 
cess is both tedious and error-orone. The existing interface 
does not provide an optimal user enviornment# although it 
does offer a base for a higher level user interface. 
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2. Display List Structure 



The hierarchical picture structure provided by the 
three construct levels is supported by the i mpl einent at i on of 
a segmented display list (51. This allows for the dynamic 
modification of each construct level which is a necessity 
for an interactive graphics system [71. A significant 
aspect of this implementation is that it supports the con- 
cept of shared display code. This is analogous to a conven- 
tional subroutine call which allows sections of code to be 
used repeatedly. Thus/ a user can define one element struc- 
ture and by associating it with an object several times/ 
cause the element to appear repeatedly in a picture. 
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IV. GENERAL INTERFACE DESIGN CONCEPTS 



The existing user interface levels supporting the Vec- 
tor General and the environment in which it resides has been 
briefly outlined. The present system does not provide an 
adequate interface^ but does provide the base for the 
further development of the system. The environment created 
by the UNIX operating system also supports the concept of a 
high level graphics interface for the Vector General 
display. The tools for constructing a high level interface 
were available# the decision now was how to design an inter- 
face package that could utilize the existing environment and 
provide an optimal user interface. 

A. GRAPHICS LANGUAGE DESIGN 

In designing a hioh level interface the main considera- 
tion is the develooment of a high level graphics programming 
language. The need for such a language for the construction 
and manipulation of graphical data cannot be overlooked. 
The ease with which a system can be programmed is a major 
factor in determining how a system will be utilized ( 81 . 

A graphics language must provide a method for describing 
pictures (PI. The language must have facilities for 
describing not only non-geometric entities in a simple form 
but also provide a way to describe two and three dimensional 
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geometric entities. Additional facilities should be avail- 
able for scaling^ translation and rotation [10], 

Oevelopement of a high level language that provides 
these features can be approached in several different ways, 
A set of graphic functions or subroutines can be developed 
to be used by an apolications program, written in a high 
level programming language. Another approach is to utilize 
the high level language of the host computer and extend it 
to perform a variety of graphic functions. This extension 
can be accomplished by changing the existing compiler to 
handle graphics functions or by developing a preprocessor. 
If a suitable high level language is not available on a sys- 
tem, then the development of a language specifically for 
graphics could be considered. This language would reguire 
not only the development of graohic functions but must also 
provide a 1 go r i t hm i c -t yoe statements, procedures or 
subroutine capabilities, and should be interactive [91, 

The goal for the Vector General was the development of a 
high level general purpose language. The UNIX operating 
system provided the high level language C, that has facili- 
ties for handling many different data types, adeguate con- 
trol structures and data structures for algorithm represen- 
tation. It also provides a simple subroutine calling format. 

1 

Because of the availability of the high level 1 anguaoe the 
development of a new graphics language was rejected. The 
decision was to either incorporate graphical functions into 
this host language by extending the language or by 
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developing a subroutine library package. In general^ 
several reasons can be stated for not selecting the 
subroutine library approach. These include the lack of con- 
venience of using subroutine calls exclusively^ inefficient 
data structures provided by the host language^ and lack of 
facilities in the host language to support a wide variety of 
applications till. The C-language provided all the neces- 
sary facilities and convenience. The simplest^ and most 
logical approach was the implementation of a high level 
subroutine package utilized by an applications program writ- 
ten in C, 

The process taken in developing this subroutine library 
is outlined by W. M. Newman and R. F. Sproull [121 : 

1. Select a suitable language on which to base 
the system. 

2. Design a set of functions for graphical 
i nput and ou t out . 

3. Write a or og rammer's manual. 

y. Write the software# to perform the graphic 
f unc t i ons . 

This approach was taken to insure the development of a user 
oriented graphics design rather than one that was merely 
easy to program and implement. 
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B. CONSIDERATIONS FOR A USER ORIENTED DESIGN 



One of the goals of this interactive subroutine library 
is to provide a general purpose high level package that will 
support a wide variety of applications. Additionally, it is 
important that the system be user oriented. This means that 
the resulting graphics orograms should be as easy to write 
and maintain as any other interactive orogram. The design 
has to provide a clear and vivid means of describing the 
pictures a user wants to create 1131. 

In trying to produce this type of user oriented package 
several requirements have to be met by the design specifica- 
tions. 

1. Graphics Primitives 

A graohics system should orovide a small number of 
powerful graohics primitives Ifll . These should be designed 
in such a way that the user is required to concentrate on 
the picture being described rather than on the hardware 
features of the machine. The user must be able to construct 
logical picture segments, combine them into a meaningful 
picture and then manioulate any combination of these picture 
segment s 1133. 

2. Default Parameters 

Default parameters should be skillfully introduced 
into the system [83. This eliminates a novice user from the 
irritating details of the system. If default values are 
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automatically included^ a novice user can concentrate on the 



basic problem of describing a picture, 

3. Error Diagnostics 

User paramaters should be checked and all errors 
should provide informative diagnostics. Errors should only 
activate di agnos t ic routines# and they should never force 
the termination of a user program [10], A user should be 
able to trace and correct errors with a minimum of effort. 
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V. VECTOR GENERAL USER INTERFACE DESIGN 



The design of the Vector General high level interface 
is implemented in the form of subroutine library functions 
which are utilized through programs written in the high 
level language C. Every effort was made to limit the number 
of functions without limiting the hardware capabilities of 
the Vector General. The design of this primitive set is 
based on the concept of picture structure^ as defined by the 
constructs oicturef object and element. 

A. PICTURE STRUCTURE AND USER ASSOCIATION 

The present interface provides the capability of 
describing pictures as a collection of objects with associ- 
ated elements and attributes. The framework for this logi- 
cal description of a picture and the implementation of a 
structured display file is orovided by the existing inter- 
face. This isf however^ inadeguate because within this 
framework a user cannot easily generate the actual display 
instructions that make. up each element. Additional capabil- 
ities for easily describing a logical picture element and 
its association with other elements and with the picture is 
orovided by the design described here. 
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The implemented design introduces the concept of an ele- 
ment block. An element block consists of a series of move- 
draw instructions or of ASCII character data. This approach 
provides a flexible wav for clearly isolating and naming 
specific picture segments. Additionally the responsibility 
of dimensioning arrays for each element display list is 
removed from the user and is instead managed by the software 
interface. This dynamic allocation and management of display 
lists by the software interface greatly extends the flexi- 
bility of an element block. Each element block can contain 
not only graphic functions but any of the C-language arith- 
meticr conditional or logical statements^ as well as 
subroutine calls. A user can also define a graphical entity 
within an element block recursively. 

Many problem solutions are most appropriately defined in 
recursive terms. Wirth sites several examoles of graohic 
patterns that are most easily described by a recursive algo- 
rithm [151. The caoability of defining elements by recur- 
sive algorithms provides the user with another powerful 
tool . 



In addition to the element block structurinof a primi- 
tive is provided so that the user can easily establish the 
desired element* object re 1 a t i onsh i os . This provides an 
easy and concise method for loaically constructing a pic- 
ture. With this primitive any number of element blocks can 
be associated with an object at one time or at several dif- 
ferent times within a program. 
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B. SELECTING NON-LIMITING PRIMITIVES 



The Vector General provides 12 different vector types/ 
arcS/ circles/ ASCII characters and has the facilites for 
creating three dimensional images. Incorporating the flexi- 
bility of 12 vector types and two or three dimensions within 
a limited set of graphic functions presents several prob- 
lems. The hardware capabilities of the Vector General must 
be available to a high level user in a concise and logical 
manner. Extending the function set to include separate func- 
tions for each vector type and for two or three dimensions/ 
is not appealing because it provides a user with too many 
opportunities for meaningless and erroneous operations [121. 
The other possibility is to use variable length parameter 
lists for a small function set. The C-lanquage supports the 
use of varible length parameter lists and this approach is 
implemented without compromising other factors such as ease 
of use/ simplicity/ and understanding. This approach lead 
to the development of nine functions which/ in combination/ 
allow utilization of all of the Vector General facilities in 
creating an element block and establish the desired object/ 
element linking. A complete description of these functions 
can be found in Appendix A. 
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C. NAMING CONVENTION 



The constructs object/ element and picture provide a 
multi"1evel naming structure This structure allows a 
user to associate integer names with each object and element 
that is created. These integer names are assigned values by 
the user interface. Additionally each element is also asso- 
ciated with an array name. This naming convention/ which 
requires user-interface interaction is inadequate for a high 
level interface. A naming convention that allows a user to 
independently assign meaningful names to objects and ele- 
ments is required. The high level interface design 
described here provides a simple naming process which 
requires a user to specify an element or object name as a 
quoted character string within a parameter list. A name is 
associated with each element and object as they are created 
by the user. There are no limitations imposed on the user 
in assigning names exceot that each name must be unique. 
Each object and element name is used throughout the program 
to reference a specific picture segment. This implementa- 
tion provides a flexible and easy method for a user to asso- 
ciate meaningful names with each object and element. 

The existing interface supports the concept of shared 
display code/ thus allowing for the repetition of an element 
in a picture. This repetition is accomplished by associat- 
ing an element with several objects or with one object 
several times. This latter case requi res that a user be 



able to uniquely reference each occurrence of an element 



within a specific object. The naming convention had to be 
extended to handle this situation, A primitive has been 
designed that allows a user to assign any number of unique 
aliases to a specific element block. An element can be 
associated with an object several times» each association» 
however^ is established by using an alias. In this way each 
occurrence of an element within a specific object can be 
uniquely referenced by its alias. 

D, ERROR DIAGNOSTICS 

All functions and user routines provide error checking 
and diagnostic information. An error will never cause the 
termination of the user's program. Every effort is made to 
allow a user's program to run to completion# so a user will 
receive some visual feedback from the Vector General display 
screen. A picture# even one that results from several 
errors can act as a useful debugging aid in itself. 

E. HIGH LEVEL USER ROUTINES 

In order to provide a comprehensive graphics package# 
the naming convention and picture structure concept has to 
be applied to the lower level user routines that dynamically 
change and manipulate picture segments. These routines are 
incorporated into this high level structure. When possible 
several low level routines are combined to provide the user 
with a simpler and vet more powerful routine. For example# 
separate routines for the deletion of an object and element 
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from the display screen are provided at the lower level. 
These two routines are combined into one routine that erases 
the entire picture^ an objectr or any number of elements 
associated with a specific object. Add i t i ona 1 1 y r a routine 
is included so a user can not only erase an element block 
but also free up the memory locations associated with the 
element block. / 

The advantages of allowing a user to manipulate display 
list storage lies in the fact that it is extremely difficult 
for the software interface to determine which display list 
structures are no longer reauired and should be removed. 
The user on the other hand knows precisely when a specific 
item is no longer needed ( 161 . The system makes available a 
finite area for the creation of display lists. Erasing an 
element does not release memory. Elements still exist and 
can be reassociated with the picture at anytime. The user 
should have the ability to optimize this storage area# by 
releasing elements that are no longer reguired. This is 
particularly important when a user program exceeds the allo- 
cated display list storage. Only by selectively removing 
elements from memory and releasing the related memory loca- 
tions can new elements be created. A user can extend the 
systems storage limitations by efficiently managing the 
display list storage area. 
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VI. RECOMMENDATIONS 



The implemented graphics subroutine library provides a 
general purpose interactive graphics package. The routines 
provided for using the external display control devices are 
adequate^ but can be extended to provide a simpler package 
for a user. For examole. the routines that control the 
function switches and the function switch lamps could be 
combined to provide a simpler interface. A varietv of 
routines for utilizing the light Pen should be available to 
a user. For example^ a light pen tracking routine would ben- 
ifit the system. 
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VII 



CONCLUSION 



The high level general purpose graphics subroutine 
library discussed in this thesis is operational. Initial 
test programs indicate that the system does provide a sim- 
ple/ but powerful approach for the development of interac- 
tive graphics programs. 
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APPENDIX A: USER REFERENCE MANUAL 



I. INTRODUCTION 

The vector general is an interactive graphics display 
system which has been interfaced with the PDP-11/50 comput- 
er, The display interacts with a PDP-11 user by displaying 
pictorial information on the surface of a cathode ray tube 
and by accepting information from its external control dev- 
ices. The external devices consist of an alphanumeric key- 
boardf 32 lighted function switcheSf 10 control dials# and a 
light pen. Through a C-callable interactive graphics program 
library# the pictorial information desired by a user can be 
described# altered and manipulated. This manual will not 
discuss in detail the electronic functions of the vector 
general# or the vector general's interface with the PDP-11, 
The purpose of this manual is to instruct a user in the 
creation and manipulation of pictorial data on the vector 
general display. 

This manual describes the use of a C-callable interac- 
tive graphics program library. A knowledge of the C- 
programming language is assumed. The user is also directed 
to Appendix B for a brief description# calling format and 
error diagonistic information on each of the user interface 
rout i nes . 
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II. .THE VECTOR GENERAL DISPLAY SYSTEM 



A more detailed discussion of the vector general can be 
found in the Users Manual for the Vector General Display 
Unit [61 and the Design Manual for the Vector General 
Display Unit 151 . 

A. THE display 

The vector general is a cathode ray tube (CRT) display 
on which a visible pattern can be created by the movement of 
an electron beam. The electron beam causes a florescent 
spot to appear on the face of the display tube. The move- 
ment of the beam is controlled by a method called random 
scan^ which in effect steers the soot in a straiaht line 
between two points on the display screen. The resulting 
line or vector^ combined with others^ creates a picture or 
pattern on the display screen. 

To maintain a clear picture on the display screen re- 
quires that the pattern be redrawn on the tube repeatedly at 
approximately thirty to forty times a second. Each repeti- 
tion is called a frame and the frequency at which it is 
redrawn is called the refresh rate. If the pattern is not 
repeated often enough, or more information than can be 
redrawn in a frame is displayed, a distortion of the picture 
will occur on the display screen. This distortion is called 
f 1 i c ke r , 
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B. HARDWARE FEATURES 



The system has several hardware features# in addition to 
a vector generator# which greatly extends its capabilites. 
These include# the ability to produce three dimensional fig- 
ures# an ASCII character set# and the hardware generation of 
arcs and circles. Other features provide the hardware 
mechanisms for the rotation and translation of user speci- 
fied picture segments. These hardware features are con- 
trolled and coordinated by the display controller. The con- 
troller is responsible for handling the communications 

I 

between the user interface# the external control devices and 
the display hardware. 

The main ourpose of the external control devices is to 
facilitate user interaction with the display. These devices 
include an alphanumeric keyboard# 32 lighted function 
switches# 10 control dials and a light pen. 

Additional information on the vector general hardware 
can be found in the Graphics Display Reference Manual (11 
and the Graphics Display System Technical Manual [3], 

C, THE SYSTEM INTERFACE 

A vector general user defines pictorial data and its 
manipulation within a C-language program. The execution of 
the program# on the PDP-11/50# causes the vector general 
software interface to be activated. It is this software 
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interface oackage» which communicates user requests and 
receives information from the vector qeneral controller. The 
interface package passes user requests^ in the proper form» 
to the diplay controller. The controller will activate the 
proper generator (ie. character^ vector^ arc/circle) which 
will output the desired informationf requested by the user^ 
on the diplay screen. The controller will also oass infor- 
mation from the external control devices back to the user 
via the interface software. This relationship is illustrated 
in figure A- I . 




ALPHANUMERIC CONTROL FUNCTION LIGHT 

KEYBOARD dials SWITCHES PEN 



Interface Relationship with the Vector General 

FIGURE A-1 
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D. INTERFACE WITH EXTERNAL DEVICES 



Each of the the external interactive devices communicate 
directly to the vector general controller. Information from 
these devices is returned to the user via the controller and 
the user i n t e r f ace , ' The user program may utilize the infor- 
mation returned from these devices to control program flow. 
This allows a user to interactively control and manipulate 
the pictorial information at display time. Specific user 
routines which activate these external devices and provide a 
communications channel with the user are discussed in detail 
in later sections of this manual. 

1, Alphanumeric Keyboard 

The alphanumeric keyboard allows the user to input 
information in the form of ASCII character codes. Through 
the user interface the user can disolay the information on 
the vector general disolay screen. The data entered from 
the keyboard can also be returned to the user program for 
process i ng . 

2. Function Switches 

The 32 lighted function switches provide the user 
with information which can be used to interactively manipu- 
late pictorial data at disolay time. Each function switch 
can be assigned specific meaninq by the user program. The 
user interface returns^ from the controller to the user# 
information on which function switches have been pressed. A 
user program could use this information to selectively 
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rotate/ translate or perhaos scale particular picture seg- 



ment s * 

3, Control Dials 

The 10 control dials provide numeric information to 
the display controller/ specifying the degree to which each 
dial has been turned. This information/ through the user 
interface/ can be provided to the user. A user orogram may 
utilize the values of the variable control dials in deter- 
mining the distance or rate at which a oortion of the pic- 
ture may be moved or rotated. 

A. Light Pen 

The light pen/ a wand containing a photo cell/ can 
be used to selectively point to different picture segments 
on the disolay screen. The interface provides a user pro- 
gram with information on which picture segment was pointed 
to by the light oen. A user program can turn the light oen 
se 1 ec t ab i 1 i t y of soecific picture segments on or off. For 
example/ an interactive user might select sections of a pic- 
ture for erasure by pointing to them with the light pen. 

III. initialization 
A. INTERFACE INITIALIZATION 

The vector general disolay system and the interface 
software with the PDP-11 must be initialized before any data 
can be displayed. The initialization routine sysinit must 
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be called before any other routines are utilized. This 
routine sets all the system default parameters, such as the 
screen coordinate system. 

If for some reason the initialization cannot be complet- 
ed the user program will be terminated. This error usually 
occurs because another user is accessing the vector general. 

B. DISPLAY INITIALIZATION 

1. Coordinate System 

The user can specify a two or three dimensional 
cartesian coordinate system, of any scale. All display coor- 
dinate values referenced by the user will be interpreted 
according to this coordinate system definition. A user may 
redefine the coordinate scale at any time in a program. The 
user will define the coordinate system in a call to the 
routine coordsys. 

coordsys(dim,minx,maxx,miny,maxy [,minz,maxzJ )J 

The routine requires the user to specify if the coordi- 
nate system is to be two or three dimensional and the range 
of each coordinate. If the parameter dim is two, indicatina 
a two dimensional coordinate system is desired, the ranoe of 
the z coordinate can be omitted, and will be ignored if it 
should be included. 

If this routine is not called by the user the default 
coordinate system will be used. This default system is 
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defined as three dimensional with the x , y , z coordinates 
ranging from -100,0 to 100,0. All coordinate values will be 
interpreted by this default system when coordsys is not 
called by the user , 

2. Picture Scale 

The rectangular^ 13 by 1^ inchf portion of the 
display screen that can be viewed by the user is called the 
visible space. The maximum picture space is larger than the 
visible spacer covering an area of 30 by 30 inches. This 
extra area allows a user to rotate or move part of the pic- 
ture to the extreme boundries of the visible space without 
any distortion. It also permits limited zooming. 

The pictorial data being displayed can be adjusted in 
sizer or scaledr by two different controls. Oner the gain 
control dials on the vector general display unit allow the 
user to manually manipulate the picture scale. The second 
provides scale control within the user's program by callina 
the routine vapscal. This routine is discussed in detail in 
Section V of this manual. 

IV. CREATING A PICTURE 
A. PICTURE STRUCTURE 

All of the information that a user desires to display on 
the vector general must be incorporated into the 
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hierarchical picture structure defined by the user interface 
package. The three hierarchical levels are defined as; pic- 
ture^ objectf element. These levels specify the underlying 
structure of the graphical display and determine the opera- 
tions a user can perform on information associated with 
each level. 

The term picture refers to all of the data that is to be 
displayed on the vector general display space. The term 
element refers to the smallest picture segment which can be 
independently referenced and changed without affecting the 
remainder of the oicture. Each element# or independent pic- 
ture segment# has a unique name associated with it. A col- 
lection# or meaningfull grouping# of elements is called an 
object. Each object is also labeled by a unique name so it 
can be easily referenced by a user. Figure A-2 illustrates 
the relationshiq of the three levels in the actual structure 
of a oicture. 

An element is completly described and named by the user. 
It can describe either graphical or ASCII character data. 
An element can be independently added or erased from the 
display screen. It can be caused to blink or be specified 
as being light oen selectable. 

Each element must be associated with at least one object 
before it can be displayed on the vector general. An object 
can consist of one or more elements. A user is reponsible 
for establishing the desired ob j ec t -e 1 emen t association# 
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Hierarchical Picture Structure 
FIGURE A-2 
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and for specifying a unique name for each object. Each user 
defined object can be independently rotated# or translated 
to any section of the 30 by 30 inch display space. An ob- 
ject can be added or erased from a picture# scaled# and 
specified to blink or to be light pen selectable. Each 
object's intensity can be varied in order to give three 
dimensional objects their depth queuing. These actions# when 
applied to a specific object# affect every element that has 
been associated with it by the user. 

A picture can contain one or more objects. The coordi- 
nate scale and picture scale defined by the user affects the 
entire oicture. A picture’s coordinate scale can be varied 
but this action will affect every object defined as part of 
the picture. An entire picture can also be erased# speci- 
fied to blink or be light pen selectable. 

A summary of the operations for each level of the 
hierarchy is outlined in Figure A-3. 

B. CONSTRUCTING AN ELEMENT 

Every element is comoletely described by the user within 
an element block. There are two types of element blocks. A 
draw element block# describes graphical information. The 
other# a character element# describes ASCII characters that 
are to be displayed. Each element is uniquely named and 

I 

this name will be used to reference this particular struc- 
ture. 
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1. Draw Element Block 

A draw element block represents a group of draw 
instructions that describe a specific structure# or picture 
segment. These draw instructions include setvector# move# 
line# arc and circle. A draw element block begins with a 
call to the routine drawele and is terminated by a call to 
the routine endele. The draw instructions that are executed 
between drawele and endele describe the actual picture seg- 
ment. 

The only parameter required by drawele is a quoted char- 
acter string# or pointer to a character string# specifying 
the name the user wants to associate with this element. 
This name will be used throughout the program to reference 
this element block. 

The basic draw element block# and the related draw in- 
structions are represented in the following format: 

-- dr awe 1 e ( "e 1 emen t -name " ) » 

I se t vec t o r ( V t ype # vmode # tine] # [scale] )# 

I 

I • 

I 

I • 

I 

I • 

I ---setvectortvtype# vmode# tine] # [scale] ); 

1 ! move (x# [yl # tz] )» 

! I 1 ine(x# tv) # [z] ) ; 

1 I c i rc 1 e (d i r # cent X # (cent y ]# teen t zl ) # 

I --- a rc ( d i r » cent X # [cent y] # [cent z ]# endx # [endy] # [endz] ) ; 

I 

I • 

I 

I • 

I 

f • 

--- ende 1 e ( ) » 



The user can select one or more of the twelve vector 



types in constructing an element. These vector types 
describe how the coordinate data will be interpreted in 
drawing a vector on the display screen. The choice of a vec- 
tor effects the parameters that will be passed in each of 
the mover line# circle or arc instructions. The user speci- 
fies a vector selection by callino the routine setvector. 

a. setvector - This draw instruction must be called 
immediately after draweler and may be called any number of 
times within the element block. Each setvectorr and the draw 
instructions that follow itr comprise a subgroup. The set- 
vector instruction determines the manner in which the liner 
mover arc and circle instructions in the subgroup will be 
interpretedr as well as their visual appearance on the 
display screen. The routine is called with the following 
parameters: 



set vec t o r ( V t yoe r vmode (rind (rscalellr 

The parameter vtyoe specifies which one of the twelve 
vector types the user wants the following group of liner 
mover arc and circle instructions to utilize. The parameter 
vmode indicates the vector moder or appearance of the vec- 
tors to be drawn (ier solid liner dotted liner etc.). Cer- 
tain vector types reguire additional informationr this in- 
formation is specified by the parameters i nc and scale. 



TABLE A-I 



SUMARY OF VECTOR TYPES 



NAME DESCRIPTION 

VA - vector absolute^ each coordinate is specified 
with respect to the origin. Each point(x,y,z) 
references a unique point on the display screen. 

VAX - vector absolute aut o” i nc rement x, every draw 
instruction causes the y and z absolute 
values to be updated while x is stepped by a 
constant value. 

VAY - vector absolute auto-increment y^ every draw 
instruction causes the x and z absolute 
values to be updated while y is stepped by a 
constant value. 

VAZ - vector absolute auto”i nc rement Zf every draw 
instruction causes the x and y absolute 
values to be updated while z is stepped by a 
constant value. 

VR - vector relative^ each Xf y» z coordinate 
value indicates the amount that is to be 
added or subtracted from the previous absolute 
coordi nate point. 

VRX - vector relative auto-increment Xf each draw 

instruction causes the y and z coordinate values 
to be incremented by the specified value while 
X is stepped by a constant value. 

VRY - vector relative auto-increment y» each draw 

instruction causes the x and z coordinate values 
to be incremented by the specified value while 
y is stepped by a constant value. 

VRZ - vector relative auto-increment Zf each draw 

instruction causes the x and y coordinate values 
to be incremented by the specified value while 
z is stepped by a constant value. 
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TABLE A-I 
(cont i nued) 



INC2- two dimensional incremental vector/ a 

relative vector that optimizes storage re- 
quirements. The coordinate increment values 
are limited to values aoprox i mate 1 y 3% of the 
user's coordinate range. 

INCX- two dimensional incremental auto-increment x/ 
is a relative vector that optimizes storage 
requ i rement s . The y coordinate value is 
incremented by a small value while 
X is stepped by a constant value. 

INCY- two dimensional incremental auto-increment y/ 
is a relative vector that optimizes storage 
requirements. The x coordinate value is 
incremented by a small value while 
y is stepped by a constant value. 

INC3- three dimensional incremental vector/ a 

relative vector that optimizes storage re- 
quirements. The X/ v/ z coordinate increment values 
are limited to values that are approximately 3% 
of the user's coordinate range. 



A brief summary of the twelve vector types is listed in 
Table A-I» a more detailed account of each vector tyoe and 
the parameters required by setvector are listed in Appendix 
B. Figure A-^ illustrates the five different vector modes 
that are available. 
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Vector Modes 
FIGURE A-a 



b. move • The draw instruction move is used to 
reposition the beam on the display screen. It will produce 
no visible line or pattern. The format of the instruction 
i s : 



move (x t»yJ ffzl); 

The coordinate values x» vr z will be either absolute or 

as 



relative values. The vector type selected in the proceed- 
ing setvector instruction will determine how the value of 
these parameters will be interpreted. The bracketed values 
indicate parameters that may be optional. 

If the user coordinate system is not three dimensional^ 
the 2 parameter can be omitteo^ ana will be ignorea if it 
should te included. 

c. line - The line instruction/ draws a visible 
line or vector on the display screen. The line is drawn 
from the present beam locaton to the specified end point. 
The format of the instruction is: 

line(x l/y] (/zl)/ 

The coordinate values x, v/ z will be either absolute or 
relative values. The vector type selected in the previous 
setvector determines how the value of these parameters will 
be interoreted. 

If the user has defined a two dimensional coordinate 
system/ the z parameter can be omitted/ and will be ignored 
if it should be included. 

d. circle - The circle instruction will draw a cir- 
cle beginning at the present beam location about the center 
point specified by the user. The difference between the 
present beam location and the center point determines the 
radius of the circle. The instruction is used by the fol- 



lowing format 



c i rc 1 e (di p» cent X {»centy] (/centzl); 



The parameter dir indicates in which direction the cir- 
cle is to be drawn, clockwise or counterclockwise. The 
number of parameters required and their values are deter- 
mined by the vector type selected in the previous setvector 
instruction, A circle cannot be drawn by any of the four 
incremental vectors. 

If the user coordinate system is two dimensional, the z 
parameter can be omitted, and will be ignored if included, 

e, arc - The arc instruction will draw an arc from 
the present beam location, about the specified center point, 
to the desired end point. The distance between the starting 
point and the center point determines the radius of the arc 
being drawn. The instruction format is : 

✓ 

arc (di r , cent X [,centy] C , cent zl , endx (,endyl [,endz]); 

The parameter dir, gives the direction the arc is to be 
drawn, clockwise or counterclockwise. The coordinate values 
are determined by the vector tyoe selected in the previous 
call to setvector. An arc cannot be drawn by any of the four 
incremental vectors. 

If the user coordinate system has been defined as two 
dimensional, the z parameters can be omitted, and will be 
ignored if included. 

If the distance from the starting point of the arc to 
the center ooint, and the distance from the end point to the 



center point are not equals the resulting arc will contain a 
straight line. The straight line results from the arc gen- 
erator trying to compensate for the two different distances 
to the center point. One distance will be used to determine 
the radius of the arc^ the arc will then be drawn using this 
radius. The arc will stop at the systems new defined end 
point and a straight line will be drawn to the end point 
that had been specified by the user. The resulting arc ap- 
pears in the following form! 




2. Character Element 

A character element represents ASCII character data that 
is to be incorporated into the oicture structure. A user can 
specify a character element containing ASCII, special vector 
general characters and formatting symbols to be displayed on 
the vector general display screen. A user can select from 
four character sizes and has the option of selecting a 
slanted character set. The text can be displayed horizon- 
tally or vertically on the screen. The vertical position 
causes the characters to appear as if they were on a page 
that had been rotated ninety decrees counter clockwise. The 
user can select the position on the screen where the string 
is to begin, or can output it relative to the present beam 



position. 

Each character element is given a unique name by the 
user. This name will allow the user to easily reference 
each character element, A character element is represented 
by the following format: 

charele("element-name"/String»size/wdir,slant/x»y); 

The parameter string can be either a quoted string 
within the parameter list or a pointer to a character string 
or array. The character string will begin at the pointCx^y) 
or can be output relative to the present beam location by 
replacing the x and y parameter with the constant VGREL, 
For example# the following character element# when linked to 
an object# would be outout relative to the present beam 
position: 

charele("element-name"#"IMow is the time"#SZ^#HOP#SLNT#VGREL)» 

A summary of the character element parameters is 
presented in Table A-II, The character set available on the 
vector general is illustrated in Figure A-5, All of the vec- 
tor general characters can be represented within a character 
string. The special formatting symbols and symbols for the 
special vector general characters are listed in a Appendix 
0 , 
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TABLE A-II 



summary of character element parameters 
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wdir: write direction 

HOR / 00 - write characters horizontally 

VER / 0200 “ write characters vertically 

slant: specifies regular or slanted characters 

SLNT / 00 - slanted characters 

NSLNT/ 01 - regular characters 
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Character Set 
FIGURE A-5 
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C. LINKING ELEMENTS TO OBJECTS 



Draw and character elements represent the smallest pic- 
ture segment that can be independently referenced by the 
user. In order to display an element it must be associated 
with at least one object. An object represents the smallest 
entity that can be displayed independently on the vector 
general screen. 

1. Object Routine 

Each object is given a unique name so it can be 
easily referenced by the user. Elements can be linked to an 
object at one time or by several different calls to the 
routine called object. An object can consist of one or more 
elements. A specific element can be linked to several dif- 
ferent objects^ or may be linked to one object several 
times. This ob j ec t -e 1 ement association or linking is esta- 
blished by the routine object. This routine has the follow- 
ing format; 

object (num/ "object-name"f"element-name"r . . . / “element-name ") ! 

The parameter num indicates the number of elements that 
are to be linked to the named object by this call. The ele- 
ments are referenced by the names specified^ by the user^ in 
the preceding drawele and charele routines. Since each ob- 
ject is associated with a unique name> a second call to 
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object/ with a duolicated object name# will cause the ele- 
ments to be added to the object first associated with that 
name . 

When an element is linked to a specific object several 
times# the user can no longer reference a specific oc- 
currence of this element within the object# for example: 

object (3# "T ree"# "branch” # "branch"# "branch" ) # 

In this case the element branch has been linked to the 
object tree three times. When displayed# element branch 
will appear three times. Now /however# the user cannot 
uniouely reference a specific occurrence of the element 
branch. If the element called branch was selected to be 
erased# the first occurrence of branch would be erased from 
the screen. In many instances it may desirable to uniquely 
reference each occurrence of an element within a specific 
object. This can be accomplished by associating several 
unique names with an element. The routine copyele provides 
thi s capabi 1 i ty. 

2. Copyele Routine 

This routine allows a user to assign several unique 
names to a specific element structure. In this way# an ele- 
ment structure can be associated with an object several 
times and each occurrence can be uniquely referenced. The 
routine is represented by the following format: 
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copyele(num» "ele'nent-name"» ”copyl-name"» "copy2-name"» . . . 3 } 



The parameter num indicates the number of additional names a 
user wishes to associate with the named element structure. 
The "e 1 emen t -name" refers to a previously defined draw ele- 
ment or character element block. Each of the "cooy-names" 
must be unique. 

Now reconsider the previous example. If the element 
branch is associated with two other unique names and these 
three names are used in the ob j ec t -e 1 ement linking, each 
occurrence of the structure can now be uniquely referenced 
by the user. The following two statements will accomolish 
thistask. 

copyel e(2, "branch", "branch 1", "branch^") ? 
object(3/"tree", "branch ","branchl","branch2")? 

V. DISPLAY MANIPULATIONS 



A. USER ROUTINES 

After the user has incorporated all data that is to be 
displayed into the desired picture structure, it can now be 
manipulated and transformed. The following user routines 
provide the means to manipulate the picture, objects and 
elements that have been created by the user. 



A description of each user routine# calling format and 
error diagnostics are included in Appendix B. 

1 . Blink 

The display blink mode can be set for the entire 
picture# single object or for any number of elements associ- 
ated with a specific object. Modifying the blink mode of an 
object affects all the elements associated with that object. 
The routine blink will turn the blink mode on or off for the 
specified picture segment. 

2. Erase 

The entire picture# a single object or any number of 
elements associated with a specific object can be erased 
from the display screen. The picture segments that are 
erased from the screen can be redisolaved by again estab- 
lishing the desired ob j ec t -e 1 emen t association. This is 
accomplished by calling the routine object# as described 
earlier. Erasing an object will affect all elements associ- 
ated with the named object. 

3. Input Data from the Display Keyboard 

The routine indata allows a user to receive and out- 
put characters from the vector general keyboard onto the 
display screen. The ASCII character data is also placed in 
a user specified character array for processing by the 
user's program. Up to one line of text can be entered# data 
entry is terminated by a carriage return. The termination 
of the data entry also erases the output characters from the 
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display screen. 

4. Intensity Offset 

The routine intoffset allows the user to vary the 
intensity level of a three dimensional objects or impose a 
screen cut-off plane for the named object. 

5. Intensity Scale 

The routine intscale allows a user to vary the in- 
tensity of a three dimensional objectf this provides the 
depth-cueing or shading for a three dimensional object. 

6. Light Pen 

The light pen se 1 ec t ab i 1 i t y of the picture^ a single 
objectf or any number of elements associated with a specific 
object can be turned on or off by the routine called 
Ightpen. This determines what picture segments will be 
affected by light pen interactions. 

7. Remove 

The routine remove provides a user with the ability 
to release the memory locations associated with a specific 
element structure. The user can remove the picture and 
release all the memory locations that have been used to 
de scribe all the existing elements. Additionally the picture 
will be erased from the screen. Each element that is removed 
from memory can no longer be referenced or linked to ob- 
jects. An individual element can also be removed from 
memory^ this will cause every occurrence of the element to 
be erased from the screen and the memory locations 
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associated with the element's description will be released. 
The user can specify an element for removal by either it's 
original name or by any of the copy names associated with 
it. Remove results in the elimination of all occurrences and 
all copies of an element from the display screen. A element 
that has been removed can be redisplayed only by recon- 
structing the element block and by again establishing the 
desired object-element association, 

8. Rotate 

This routine allows a user to rotate an object about 
the Xf Vf and z axis. The rotation of an object affects all 
elements associated with the named object. Arcs» circles 
and characters are always drawn in a plane parallel to the 
screen# and are rotatable in a three dimensional coordinate 
system about the z-axis. 

9 . Scale 

The routine scale allows a user to scale indepen- 
dently any object of the picture. All elements associated 
with the object will be scaled by the specified scale fac- 
tor, 

10. T rans 1 ate 

The routine trans allows the user to move an object 
anywhere in the display space. The object and all its asso- 
ciated elements can be moved in the x# y# and z plane. Con- 
tinually translating an object by very small increments will 
cause it to appear as if it is moving across the display 
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screen. The following example will move the named object 
diagonally across the display screen; 

X = y = .01 //coordinate system is 20 
//ranging from -1 to 1. 

for(i=0;i<100;i++) 

{ trans("box”# x/ y)? 

X = X + .01 ; 

y = y + .01 ; 

> 

VI. OTHER USER INTERFACE ROUTINES 

Additional user routines are available and are described 
in detail in the Users Manual for the Vector General Display 
Unit 16], Only a brief summary of each routine will be 
presented in this manual. 

1 . vgc 1 oc k 

This routine allows a user to set the refresh rate 
of the vector general display. The vector general is au- 
tomatically initialized with a refresh rate of forty hertz. 

I 

2 . vgd i a 1 

The routine vgdial returns to the user's program the 
values of the ten variable control dials. 

3. vggetcar 

The routine vggetcar will return to the user’s pro- 
gram a single character entered at the vector general key- 
board. If no character has been entered a -1 will be re- 

turned. This routine does not display the characters on the 
vector general display screen. 
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, vggetfsw 

This routine will return to a user's program the 
value of the 32 function switches. The values returned will 
indicate which function switches are depressed. 

5 . vg 1 amps 

This routine is used in conjunction with vgqetfsw. 
It will turn on the function switch lamp for each function 
switch that is depressed. 

6. vgpicture 

This routine causes the user's picture to be 
displayed on the vector general display screen. Nothing 
will apoear on the display screen until this routine is 
cal led. 

7. vgpost 

The routine vgpost allows the user to transform the 
pictures coordinate axis. This t rans f ormat i on will cause 
the entire picture to be reoositioned on the display screen. 

8. vgpscal 

The user can modify the scale of the entire picture 
by calling the routine vgpscal. 

9. vgterm 

This routine terminates the vector general process 
and releases all the systems resources that were being util" 
i zed by the vector general. This routine should be called 
at the conclusion of all vector general display ooerations. 
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VII 



RUNNING A VECTOR GENERAL PROGRAM 



A. PROGRAM FORMAT 

In order to properly utilize the vector general display 
system^ routines to initialize and terminate the system must 
be called. These routines initialize the vector generals 
start the actual visual display and properly terminate the 
display at the end of a users program. Each user program 
must include a call to these three routines: 





s y s i n i t ( ) ? 
vgp icturef)* 
vgt e rm ( ) ; 


The 


first routine^ sysinit^ must be called by the user 


before 


any other user interface routine is called. To 


display 


the picture that a user has described on the vector 


genera 1 


screen/ the routine vgpicture must be called. This 


rout i ne 


is called only once» and nothing will aopear on the 


sc reen 


until it has been called. Finally/ to properly ter- 


m i n a t e / 


the system requires a call to the routine voterm at 


the end 


of t>»e user program. 



0. TO COMPILE 

Once a graphics program for the vector general has been 
writted in the C-languaae it must be compiled with the user 
interface graphics subroutine library. To include this in- 
formation a user should issue the following command to 
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properly compile a vector general graphics program 

cc -0 f i 1 ename - 1 v 

In order to utilize the vector general's program 
used in this manual# the file containing these 
must be included in each graphics program. The 
command will include the filet 

^include " /us r / 1 i b/ vgcon . h " 



const ants 
constants 
f o1 lowing 
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C. SAMPLE PROGRAM 



The following is an example of a C-language vector gen- 
eral graphics program. The actual picture produced by this 
program is illustrated in Figure A-6, 

<<inc1ude "/usr/1 ib/vgcoh.h” 

m a i n ( ) 

{ 

i n t if 

sysinit(); //initailize the vector general 

//define coordinate system 
coordsys(2f-l .0/ 1 ,0/-l .0/ 1 ,0) ; 

drawe leCbox"); 

setvector(VA,LN); 

move (-1.0, -1.0); 
line( 1.0, 1.0); 

line( 1.0, 1.0); 
line (-1.0, 1.0); 

1 ine(-l .0,-1 .0) ; 
ende 1 e () ; 

charele('’name",’’%I BO / " , SZ^ , HOR , NSL NT , VGREL ) ; 

drawele("zigzag"); 

setvector(VA,LN) ; 

' move(-0.5,-0.5) 

setvector(INCX,LN, .030fl,NMG) ; 
move(.0308, .0308); 
for(i=0 ; i< 7 f i++ ) 

1 ine(.0308, .0308) ; 
ende I e ( ) ; 

//establish ob j ec t -e 1 ement relationship 
object(3,"bigbox", "box", "name”, "zigzag"); 
object (3,"smal Ibox", "box", "name", "zigzag"); 

scale("biqbox",0.‘5) f 
trans{"bigbox",-0.5,-0.5) ; 
scale("smal Ibox", 0.25); 
trans("smal Ibox ",0.5, 0.5); 

vgpicture(); //display picture 
sleep(30); //display picture for 30 sec 
vgtermC); //terminate vector general process 

} 
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Picture Disoiaved bv Sample Proaram 
FI(;URE A-6 
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D. ERROR DIAGNOSTICS 



All error messages will be printed on the PDP-11 termi- 
nal screen during the execution of a vector general graphics 
program. The error message will identify the routine that 
was executing when the error occurred and the error. The 
errors will be identified by a number, A user can identify 
the problem by referring to the listing of errors in this 
manual or by referencing the specific routine in Appendix B, 
Most errors will usually result in the termination of the 
routine being executed with control being returned to the 
user program. Every effort will be made to execute the pro- 
gram to comoletion, so at least some of the users data will 
be displayed on the vector general disolay screen. A 
description of each possible error is listed in Table-III. 
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TABLE-III 
ERROR DIAGNOSTICS 



Routine Error Numbers: 



arc 


1 


i nt sea 1 e 


12 


blink 


2 


1 gh t pen 


13 


charele 


3 


remove 


17 


circle 


a 


move 


15 


coordsys 


5 


object 


16 


copye 1 e 


6 


remove 


17 


dr awe 1 e 


7 


rotate 


18 


ende 1 e 


8 


scale 


19 


erase 


9 


set vec tor 


20 


indata 


10 


sy s i n i t 


21 


i ntof f set 


1 1 


t rans 


22 



Error Diagnostics: 



EOl 



Element block error. The specified routine 
has been called outside of a drawele block. The 
instruction will be ignored and control will be 
returned to the user's program. 



E02 



E03 



Space allocated by the system for the building 
of elements has been exceeded. See the routine 
remove in order to free up unecessary element 
memory locations. The instruction executing when 
this error occurs will be ignored and control will 
be returned to the user's program. 

The value of the parameter dir was not C or 

CC. The routine will be ignored and no arc or 

circle will be drawn on the display. 



Eoa 



A character symbol included in 
character string is undefined. 



an ASCII 
The symbol 



will be 



ignored and 
prog ram , 



control will be returned to the user's 



EOS 

E06 



The named object does not exists it has not 
been defined in a call to the routine object. 



The named element does not 
been defined in a call 
c ha re 1 e . 



exists it has not 
to either drawele or 



E07 



An element name has been duplicated in a 
drawele or charele call. Each element structure 
created by drawele or charele must have a unique 
name . 
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E08 

E09 

Ell 

Eia 

E15 

E16 

E17 

E18 

E19 

E20 



The total number of elements allowed 
by the system has been exceeded. 

The number of objects allowed by the 
system has been exceeded. 

The value of the parameter dim, 

specifying the desired number of dimensions for 
the user coordinate system is not a 2 or 3. 

The specified increment value falls outside 
of the defined coordinate system, the value will 
be ignored and control will be returned to the 
user ' s orogram . 

The X coordinate value, or the x increment 
value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error will be ignored and the move, 
line, arc or circle requested will not be drawn on 
the display screen. 

The y coordinate value, or the y increment 
value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error will be ignored and the move, 
line, arc or circle requested will not be drawn on 
the disDlay screen. 

The z coordinate value, or the z increment 
value falls outside of the user's defined coordi- 
nate system. The instruction executing at the 
time of the error will be ignored and the move, 
line, arc or circle requested will not be drawn on 
the display screen. 

The value of the oarameter num, 

soecifying the number of elements being passed in 
this routine is not between 1 and 10. 

\ 

A circle or arc cannot be drawn by an 
incremental vector. 

The length of the user buffer specified 
for the routine indata is too small. The amount 
of data input from the keyboard exceeded the 
Duffer size, characters received after the buffer 
boundry will be ignored. 
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E21 



A named element within a oarameter list 
is not associated with the specified object. The 
element was not linked to the named object in a 
call to the routine object. The routine executing 
at the time of this will stop and return control 
to the user's program. 
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I 



APPENDIX B: USER INTERFACE ROUTINE DESCRIPTIONS 



The description of the user interface routines appear 
in the same format as the routine descriptions in the UNIX 
Reference Manual at the Naval Postqraduate School Computer 
Laboratory . 
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arc 



a rc 



NAME; 



arc - draw an arc 
SYNOPSIS: 

arc (d i r ^ cen t X (/centyl C / cent 2} / endx t/endy) t/endzl)? 

dir: CC / 004 - counter clockwise 
C / 010 • clockwise 

float centx (fCentyl f » cent zl » endx t»endyl [^endzl ? 



DESCRIPTION: 

An arc is drawn from the present beam location^ about 
the designated center pointf to the user specified end 
point. If the center point is not an equal distance 
from the starting point of the arc and the end points 
an arc will be drawn using one of the dist'^nces as the 
radius. The result/ is a straight line drawn from the 
actual terminating point of the arc to the user spec i - 
f i ed end point. 

The parameters passed for the center point and end 
point of the arc are either relative or absolute 
values. The number and value of these parameters are 
determined by the vector type selected in the previous 
call to setvector. 

Arcs cannot be drawn by any of the four incremental 
vec tors . 

The z parameters are required only when the coordinate 
system is defined as three dimensional/ and will be 
ignored if included when 2 dimensional is specified. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - EOS - The draw direction was not defined 
as either C or CC. 

Error - E15 - The x value was out of bounds. 
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arc 



arc 



Error • E16 * The y value was out of bounds. 
Error - E17 - The z value was out of bounds. 
Error - E19 - Illegal arc/circle instruction 
from an incremental vector. 



ALSO SEE; 

setvector - gives parameter requirements for each 
vector type. 
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blink 



blink 



NAME: 



blink - blink the entire picture or the specified 
object or elements 

SYNOPSIS: 

action: 

ON / 01 - b1 i nk 

OFF / 00 - stop blinking action 

Parameter values: 

PIC / 00 
OBJ / -1 



To blink the entire picture: 
b 1 i nk (ac t i on r P IC ) ; 

To blink a specific object: 

bl inkfaction, OBJ, "obj name ") r 

To blink elements of a specific object: 

blink(action,num,"obj name ","elel",ele2 
i nt num ; 



DESCRIPTION: 

The blink mode for the entire picture, a single ob- 
ject or any number of elements of a specific object, 
can be turned on or off. 

Modifying the blink mode of an object affects all ele- 
ments linked to that object. 

num specifies the number of element names being passed 
in this routine, num can vary between 1 and 10. 



DIAGNOSTICS; 

All errors will be printed on the PDP-11 terminal 



71 



blink 



b 1 ink 



screen. 



Error - £05 
Error - E06 
Error - E18 



Unknown object name. 
Unknown element name. 
Value num not between 



- 10 . 
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chare 1 e 



c h a re 1 e 



NAME: 



charele - displays an ASCII character string 
on the Vector General 



SYNOPSIS: 

charele("elena(ne"fCharptrfSi2efwdir^slant»xpos/vpos); 

float xposf yposr 

size: 



SZ 


/ 


00 


- use 


previous character 


s 1 ze 


SZ! 


/ 


0100 


• set 


Size 


t 0 


100 


col. by 


60 


lines 


SZ2 


/ 


0120 


- set 


size 


t o 


81 


col . by 


^1 


lines 


SZ3 


/ 


oiao 


- set 


size 


to 


60 


col. by 


30 


lines 


sza 


/ 


0160 


- set 


size 


to 


32 


col . by 


16 


lines 



wdi r : 

HOP / 00 - write characters horizontally 

VER / 0200 - write characters vertically 

slant: 

SENT / 00 - slant characters 

NSLNT / 01 • do not slant characters 

xpos : 

VGREL- to output characters relative to the 

present beam position the parameter xoos 
should be replaced with VGREL and 
parameter ypos should be omitted. 



DESCRIPTION: 

This routine displays the ASCII character string^ 
specified by charptr^ on the vector general screen. 
The characters can be output by soecifying the desired 
coordinate starting point (xpos^yoos) or by outputing 
the string relative to the present beam location. The 
symbols available include formatting symbols and an 
extended character set. These can be included in any 
character string by including the proper identifying 
symbols. The character string formatting symbols are: 
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chare 1 e 



chare 1 e 



KEYBOARD FORMAT 
SYMBOL 



XS 

%A 

XB 

XC 

XO 

XE 

XF 

XG 

XH 

XI 

XJ 

%K 



bac k space » mo ves back one character space 
line feedf position center screen 
1 i ne Teed 

position at topfCenter of screen 
position at tOP/left corner of screen 
carriage control# line feed 
i gnored 
i gnored 

special character 

neg. line feed»moves up one line 
decreases current character size by one 
increases current character size by one 



Due to the extended character set available on the 
vector general# all special character symbols are pre- 
ceded by a percent sign. In order to have a percent 
sign appear on the screen# two percent signs (X%) must 
appear in the character string. A list of the special 
characters available are listed on the next page under 
Extended Character Set. 



All errors will be printed on the PDP-11 terminal 
sc reen . 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - EO^ - Incorrect ASCII character symbol 
found in character string. 

Error - E09 - Maximum number of elements 
per picture exceeded. 



DIAGNOSTICS 



7a 



chapel e 



charel e 





Extended Character Set 


KEYBOARD 

SYMBOL 


CHARACTER 


%space 

X! 


O 


%" 

y.n 


II 

O • 


X$ 


h 


XH 

%& 


V 

/ 


X’ 

xc 


V 

d 


X) 


:=> 


X* 


10 


x+ 




X, 





X/ 


1 


xo 

XI 


O 

t 


%2 


V 


X3 


□ 


X« 




X5 


A 
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charel e 



charel e 



%6 

y.i 

XB 

X9 

X: 

x; 

%< 

XM 

XN 

XO 

XP 

XQ 

XR 

%S 

XT 

XU 

XV 

xw 

XX 

XY 

XZ 

X t 

X 

X] 

xt 

%<- 



9 

z 

u 

n 



(TQ 

71 

J 

n 

i> 

i: 

- 6 - 

I 



=t> 

h 



o * 
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( 





chare 1 e 



c hare 1 e 



%' 

%a 

Xb 

%c 

Xd 

Xe 

Xi 

%q 

%h 

%i 

%j 

%1 

Xm 

Xn 

Xo 

Xd 

Xa 

Xr 

Xs 

Xt 

Xu 

Xv 

Xw 

Xx 

Xv 



oC 

S 

e 

TT 

X 

L 

/ * 

X 

> 

V 

•tr 

5 

/® 

c* 

o 

y 

I 

o 

z. 
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cSarel e 



c h a re 1 e 



Zz 




%{ 


r 


Zl 


1 


%> 


H 


%-< 


^4 


%? 


jH 
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circle 



NAME: 



circle - draw a circle 



SYNOPSIS: 

c i rc 1 e (d i r » cen t X (»centyl t/Centzl ) 

dir: CC / 00^ - counter clockwise 
C / 010 - clockwise 

float centx t^centyl (^centzl 7 



DESCRIPTION: 

A circle is drawn from the present beam location about 
the indicated center point. ^ 

The parameters passed for the center point of the cir- 
cle are either relative or absolute values. The 
number and value of these Parameters are determined by 
the vector type selected in the previous call to set- 
vector. 

Circles cannot be drawn by any of the four incremental 
vectors. 



DIAGNOSTICS: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Error 

Error 

Error 

Error 
E r ro r 
E r ro r 
Error 



EOl - This routine has been called outside 
of a draw element block, 

E02 - The space allocated for the buildina 
of elements has been exceeded. 

E05 - The draw direction was not defined 
as either C or CC, 

E15 - The X value was out of bounds. 

E16 - The y value was out of bounds. 

E17 - The z value was out of bounds. 

EIR - Illegal arc/circle instruction 

from an incremental vector. 



\ 



ALSO SEE: 

set vec tor 



gives parameter requirements for each 
vector type. 
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coordsys 



coordsys 



NAME: 

coordsys - define user coordinate system 
SYNOPSIS: 

coo rds ys (d i m f m i nx ^ max X » m i ny f ma X y [fdiinZfmaxz] ); 
i nt dim; 

float minx»maxxrminy^maxy (fminzfmaxzl f 



DESCRIPTION: 

Defines a two or three dimensional cartesian coordi- 
nate system^ of any scales for the user. The parameter 
dim specifies the number of dimensions required. If 
dim is 2 then only the range of x and y need to be 
spec i f i ed , 

minx must be strictly less than maxx. 
miny must be strictly less than maxy. 
minz must be strictly less than maxz. 

All subseouent user coordinate values are interpreted 
according to this user defined coordinate system. 

If coordsys is not called by the user the default 
values will be taken. The default coordinate system is 
three dimensional with x» y , z ranging from -100.0 to 
100.0, All coordinate values received will be inter- 
preted according to these default values unless the 
coordinate system is redefined by the user. 



DIAGNOSTICS: 

Any values which fall outside of the defined coordi- 
nate system will be ignored and an error message 
specifying which coordinate values were out of range 
will be printed on the PDP-11 terminal screen. 
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copyel e 



copyel e 



NAME: 



copyele - specify additional names to be used 

in referencing a specific element block 



SYNOPSIS: 

copyele(num»"elename"/"namel"»''name2”^...); 
int num? 



DESCRIPTION: 

This routine allows the user to give several unique 
names to a specific element block. In this manner# a 
user can link one element to an object several times 
and can uniquely reference each occurrence of the 
element within the object. 

num specifies the number of element names being passed 
in this routine# num can vary between 1 and 10. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - E06 - Unknown element name. 

Error - E07 - Duplicate element name. 

Error - E18 - Value num not between 1-10. 

ALSO SEE: 

drawele# object 
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drawel e 



drawel e 



NAME: 



drawele - start a draw element block 



SYNOPSIS: 

drawe1e("e1ename") * 



DESCRIPTION: 

This routine specifies the beqinninq of a draw element 
block. It associates a unique name with the grouo of 
draw instructions that fall in between this call and a 
call to endele. The resulting picture segment will 
then be referenced by the name soecifiedf as the ele- 
ment name# in this routine, 

A user may want to repeat a specific element block 
structure several times within one object. Instead of 
specifying several element blocks which describe the 
same structure a user can indicate a group of names 
which refer to one specific element block. These 
unique names each referring to the same structure can 
then be linked to an object# and each can be uniquely 
referenced. This association of several names with one 
element can be accomplished by the routine cooyele. 



DIAGNOSTICS: 

All error messages will be orinted on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - E07 - Duplicate element name. 



ALSO SEE; 

copyele# object 
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endel e 



ends 1 e 



NAME: 



endele - end of the current element block 



SYNOPSIS: 

endel e ( ) ? 



DESCRIPTION; 

Specifies the termination of a list of draw instruc- 
tions describing a specific element. The picture seg- 
ment described by this group of draw i nst rue t i ons » 
that fall between a drawele and endele call# will be 
referenced by name specified in the drawele. 

A new element block cannot begin until the previous 
block has been orooerly terminated by a call to 
ende 1 e . 



DIAGNOSTICS: 

This routine must be called to properly end a draw 
element block. If a block is not properly terminated 
prior to the beginning of a new element block# all 
drawele calls will be ignored and any draw instruc- 
tions that follow will be associated with the element 
block that has not been terminated. 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 
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erase 



NAME: 



erase - erase the specified portions of the picture 



SYNOPSIS: 

Parameter values: 

PIC / 00 
OBJ / -1 

To erase the entire picture: 
erase (PIC) ; 

To erase a specific object: 

erase(OBJ»''objname''); 

To erase elements of a specific object: 

erase(num,"objname''/"elel"/"e1e2 
i n t num ; 

DESCRIPTION: 

The entire oicturer specified object or the listed 
elements of a specific objects will be erased from the 
vector general display screen. The elements still 
exist. To redisplay any Portion of the erased picture^ 
the appropriate e 1 emen t -ob j ec t linking must again be 
done by the user. 

num specifies the number of element names being passed 
in this routine. 

DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minalscreen. v 

Error - £05 - Unknown object name. 

Error - E06 - Unknown element name. 

Error - E18 - Value num not between 1-10. 

Error - E2l - Element not associated with 
the named object. 

ALSO SEE: 

remove 
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eppormsg 



eppopmsq 



NAME: 



eppopmsq - ppint error messages on PDP-11 tePminal 
sc Peen 



SYNOPSIS: 

eppopmsg(action); 

action: 

ON / 01 - opint eppops on PDP-11 tepminal 
OFF / 00 - stoo ppinting of eppop messages 



DESCRIPTION: 

All eppop messages will automatically be ppinted on 
the PDP-11 tepminal scpeen. The usep can contpol the 
ppinting of eppop messages duping any poption of a 
ppogpam by calling this poutine. 
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i ndat a 



NAME: 

indata " input data from the vector general 
keyboard 

SYNOPSIS: 

indata(buffer»1ength/xpos»yoos)? 
char *buf f er? 
i nt 1 engt h ; 
float xpos^ypos? 



DESCRIPTION: 

This routine allows the user to enter data from the 
vector general keyboard onto the vector general 
display screen beginning at the position indicated by 
xposf ypos. The data» ASCII character codes» will 
also be placed in the user buffer specified by buffer. 
The length of the user buffer must be soecifed by the 
parameter length, A cursor will be displayed at the 
initial position and all data will remain on the 
display screen until a carriage return is entered by 
the user. All data placed in the user's buffer will 
remain unaltered. 

A listing of the ASCII character code for every key- 
board entry is listed on the next page. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal sc reen . 

Error - E15 - The x value was out of bounds. 

Error - E16 - The y value was out of bounds. 

Error - E20 - User buffer dimensioned to small. 
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000 

001 

002 

003 

00^ 

005 

006 

007 

010 

Oil 

012 

013 

01« 

015 

016 

017 

020 

021 

022 

023 

02^4 

025 

026 

027 

030 

031 

032 

033 

03a 

035 

036 

037 

oao 

oai 

oa2 

oa3 

oaa 

oa5 

oa6 

oa7 

050 

051 

052 

053 

05a 

055 

056 

057 

060 



i ndat a 



CHARACTER GENERATED KEYBOARD 





SYMBOL 


SYMBOL 


NULL 


( i anoped) 


3 Ctrl 


SO 


erase last char. 


A Ctrl 


STX 


( i qnored) 


R Ctrl 


ETX 


( i qnored) 


C Ctrl 


EOT 


( } qnored) 


D Ctrl 


ENQ 


(ignored) 


E Ctrl 


ACK 


( i qnored) 


F Ctrl 


BEL 


( i qnored) 


G Ctrl 


BS 




RS 


HT 


(LF > cent ) 


I Ctrl 


LF 




LF 


VT 


( topf cent ) 


K Ctrl 


FF 


(top» left) 


L Ctrl 


NL 


(CR, LF) 


CR 


SE 


( i qnored) 


N Ctrl 


SI 


( i ono red) 


0 Ctrl 


DLE 


(dear aueue) 


P Ctrl 


DCl 


(-LF) 


Q Ctrl 


0C2 


(-SZ) 


R Ctrl 


DC3 


( + SZ) 


S Ctrl 


Dca 


(terminate) 


T Ctrl 


NAK 


( i ono red ) 


U Ctrl 


SYN 


( i qnored ) 


V Ctrl 


ETB 


( i qnored) 


W Ctrl 


CAN 


( i ano red ) 


X Ctrl 


EM 


( ignored) 


Y Ctrl 


SUB 


( i qnored) 


Z Ctrl 


ESC 


(escape ) 


( Ctrl 


FS 


( i ono red ) 


\ Ctrl 


GS 


( i ano red ) 


1 Ctrl 


RS 


( i qnored) 


'A Ctrl 


US 


( i anored) 




Space 




sp bar 


1 




1 shift 


n 




2 shift 


n 




3 shift 


% 




a shift 


X 




5 shift 


s, 




6 shift 


1 




7 shift 


( 




8 shift 


) 




R shift 


* 




: shift 


+ 

» 




; shift 

f 


• 

/ 




• 

/ 


0 




0 
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I 




t a 

061 

062 

063 

06^ 

065 

066 

067 

070 

071 

072 

073 

07iJ 

075 

076 

077 

100 

101 

102 

103 

loa 

105 

106 

107 

1 1 0 

111 

112 

113 

1 1 a 

115 

116 

117 

120 

121 

122 

123 

12« 

125 

126 

127 

130 

131 

132 

133 

13a 

135 

136 

137 

laO 

lai 

1«2 

ia3 

laa 



indata 



1 


1 




2 


2 




3 


3 




a 


a 




5 


5 




6 


6 




7 


7 




8 


8 




6 

• 


9 

• 




• 

• 

f 


• 

• 




< 


9 


Shi ft 


— 


- 


Shi ft 


> 


• 


s h i ft 


7 


7 

• 




SI 


9 




A 


A 


s h i ft 


B 


8 


shift 


C 


C 


shift 


0 


D 


shift 


E 


E 


s h i ft 


F 


F 


s h i ft 


G 


G 


shift 


H 


H 


Shi ft 


I 


I 


Shi ft 


J 


J 


Shi ft 


K 


K 


shift 


L 


L 


shift 


M 


M 


shift 


N 


N 


shift 


0 


0 


s h i ft 


P 


P 


shift 


0 


Q 


shift 


R 


R 


s h i ft 


S 


S 


s h i ft 


T 


T 


s h i ft 


U 


U 


shift 


V 


V 


s h i ft 


w 


w 


shift 


y 


X 


s h i ft 


Y 


Y 


shift 


z 


Z 


shift 


t 


[ 




\ 


\ 




1 


] 




A 


A 




<-(sub»suDerscript) 






% 


S) 


s h i ft 


a 


A 




b 


B 




c 


C 




d 


D 
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1^5 

1^6 

1«7 

150 

151 

152 

153 

15a 

155 

156 

157 

160 

161 

162 

163 

16 a 

165 

166 

167 

170 

171 

172 

173 

17a 

175 

176 

177 

2ao 

2 ai 

2a2 

2a3 

2 aa 

2a5 

2a6 

2a7 

250' 

251 

252 

253 

25a 

255 

256 

257 

260 

261 

262 

263 

26a 

265 

266 

267 

270 



i ndat a 



e 

f 

g 

h 

i 

J 

k 

1 

m 

n 

0 

D 

a 

p 

s 

t 

u 

V 
w 

X 

V 

z 

{ 

• 

1 

> 

<o 

del 



E 

F 

G 

H 

I 

J 

K 

L 

N 

0 

P 

0 

p 

s 

T 

U 

V 

w 

X 

Y 
7 

) shift 
\ shift 
f shift 
shift 
DEL 



II 




1 


shift 


soec 




2 


Shi ft 


SDffC 


o 




3 


s h i ft 


spec 






a 


shift 


spec 


V 




5 


shift 


spec 


/ 




6 


s h i ft 


spec 




7 


shift 


spec 


cz. 




0 


Shi ft 


spec 






9 


shift 


spec 


10 


(subscript) 


• 

• 


s h i ft 


spec 


• 




• 

9 


s h i ft 


spec 






9 


spec 




S 




- 


spec 












“ 




• 


spec 








/ 


spec 




O 

A 




0 


spec 








1 


spec 




V 




2 


spec 




□ 




3 


spec 








a 


spec 




A 


(centered) 


5 


spec 




9 




6 


spec 








7 


spec 




u 




8 


spec 
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271 

272 

273 

27a 

315 

316 

317 

320 

321 

322 

323 

32a 

325 

326 

327 

330 

331 

332 

333 

33a 

335 

336 

337 

3ao 

3ai 

3a2 

3a3 

3aa 

3as 

3a6 

3a7 

350 

351 

352 

353 

35a 

355 

356 

357 

360 

361 

362 

363 

36a 

365 

366 

367 

370 

371 

372 

373 

37a 



i ndat a 



n s 




9 


spec 




• 


(centered) 


• 

• 


spec 




X 




• 


spec 








9 


shift 


Spec 


LED 




M 


s h i ft 


spec 


u 




N 


shift 


spec 






0 


shift 


spec 


f 




P 


shift 


spec 


o 




Q 


s h i ft 


spec 


Jp 




R 


shift 


spec 


T, 




S 


shift 


spec 


e 




T 


shift 


spec 


» 




U 


shift 


spec 


S 




V 


shift 


spec 


A 




w 


shift 


spec 


r 




X 


shift 


spec 


r 




Y 


shift 


spec 






Z 


shift 


spec 


L 




c 


shift 


spec 






spec 




1- 




1 


shift 


spec 


* 




A 


spec 




O ^ 






.spec 




1 1 


( b J inking) 


T 


shift 


spec 


cC 




A 


shift 


spec 






B 


Shi ft 


spec 


V 




c 


shift 


spec 


S 




0 


shift 


spec 


£ 




E 


shift 


spec 






F 


shift 


spec 






R 


shift 


spec 






H 


shift 


spec 


L 




I 


shift 


spec 






J 


shift 


spec 






K 


shift 


spec 






L 


s h i ft 


spec 


JU. 




V 


shift 


spec 


V 




M 


shift 


spec 


oJ 




0 


shift 


spec 


TV 




P 


shift 


spec 


B 




0 


s h i ft 


spec 


e 




R 


shift 


spec 


<r 




S 


shift 


spec 


< 




T 


shift 


spec 


:> 




U 


shift 


spec 


o 




V 


shift 


spec 


J 




w 


shift 


spec 


\ 

o 




X 


s h i ft 


spec 


Z. 




Y 


shift 


spec 


5J 




Z 


s h i ft 


spec 




( 


spec : 


shift 



r spec shift 
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i ndat a 



i ndata 



375 


H 


376 




377 


m 



] spec shift 
spec shift 
DEL spec 
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i ntof f set 



intoffset 



NAME: 



intoffset - object intensity offset 



SYNOPSIS: 

intoffset!" objname"»val ); 
float val ? 



DESCRIPTION: 

The intensity range of the specified object is deter- 
mined by the parameter val. If val is oner the max- 
imum intensity range is achieved. If the value is 
zerof the intensity is constant and the image has no 
dept h -cue i ng . 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOS - Unknown object name. 



ALSO SEE; 

i nt sea 1 e 
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i n t s c a 1 e 



i ntscal e 



NAME: 



intscale - modify object intensity scale 



SYNOPSIS: 

intsca1e("objname"fval )? 
float va 1 » 



DESCRIPTION: 

The intensity range of an object# which gives a three 
dimensional object its depth cueing# is determined by 
the parameter val. The range of va1 is from zero to 
one. If val is one the maximum intensity range is 
obtained# if it is zero the object has no depth cue- 
i ng . 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal sc reen . 

Error - EOS - Unknown object name. 



ALSO SEE: 

intoffset 
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1 ghtpen 



1 ghtpen 



NAME: 



Ightpen - set lightpen hookability of 

the picture/ob ject or elements 

SYNOPSIS: 

ac t i on : 

ON / 01 - Set light pen hookability 
OFF / 00 - Clear light pen hookability 

Parameter values: 

PIC / 00 
OBJ / -I 

To set hookability of the entire picture: 
lghtpen(action,PIC); 



To set hookability of an object: 

lghtoen(action/OBJ,"objname")? 



To set hookability of elements of a specific object: 
lghtpen(action,numf"objname"f"elel"f"ele2”»...); 
int num; 



DESCRIPTION: 

The user can soecify which picture segments will be 
light pen bookable. These elements designated as light 
pen bookable wi^ll be effected by light pen interaction 
^with the vector general disolay screen. 

num specifies the number of element names being passed 
in this routine^ num can vary between I and 10. 

DIAGNOSTICS: 

All errors will be printed on the PDP-11 terminal 
sc reen . 

Error - £05 - Unknown object name. 



9a 



1 ghtpen 



1 gh t pen 



Error 
E r ro r 
E r ro r 



E06 - Unknown element name. 

E18 - Value num not between 1-10. 
E21 - Element not associated with 
the named object. 
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line 



1 i ne 



NAME: 



line - draw a line 



SYNOPSIS: 

line(parx [rparyl t^parz] ); 
float parx [#oapyl (/parz) 7 



DESCRIPTION: 

A line is drawn to the location specified by the x ty t z 
coordinate values. The values may specify actual abso- 
lute coordinate points or an incremental value which 
will be added to or subtracted from the previous xtVrZ 
coordinate point. The number of oarameters and their 
values are determined by the vector type specified in 
the preceding call to setvector. 



DIAGNOSTICS: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Error - EOl - 


This 


rout i ne 


has 


been called outside 




of a 


draw element block 


• 


Error - EOS - 


The space allocated for 


the building 




of elements 


has 


been exceeded. 


Error - E 1 5 - 


The X 


value 


was 


out of 


bounds . 


Error - E16 - 


The y 


value 


was 


out of 


bounds . 


Error - El 7 - 


The z 


value 


was 


out of 


bounds . 


ALSO SEE: 












setvector - gives 


parameter requirements 


for each 


vector 


type 


• 
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move 



move 



NAME: 



move • move to the specified location 



SYNOPSIS: 

move(parx C^pary] t/parzl )7 
float parx tfpary] IfParzl ; 



DESCRIPTION: 

The beam is moved to the location specified by the 
x/y^z coordinate values. The values may specify actual 
absolute coordinate points or an incremental value 
which will be added to or subtracted form the previous 
x»y/Z coordinate values. The number of parameters and 
their values are determined by the vector type soeci- 
fied in the preceding call to setvector. 



DIAGNOSTIC: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Error - EOl - 


This 


routine 


has 


been called outside 




of a 


draw element block 


• 


Error - EOS - 


The space allocated for 


the building 




of elements 


has 


been exceeded. 


Error - E15 - 


The X 


value 


was 


out of 


bounds . 


Error - E16 - 


The y 


value 


was 


out of 


bounds . 


Error - E17 - 


The z 


value 


was 


out of 


bounds . 


ALSO SEE: 












setvector - gives 


parameter requirements 


for each 


vec tor 


t yoe 


• 
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ob j ec t 



object 



NAME: 



object - link elements to specified object name 



SYNOPSIS: 

object(numf"objname”»"elel"f”ele2"f...»); 
int num? 



DESCRIPTION: 

Associates with the named object each of the listed 
elements. This picture segments or element grouping 
will be referenced by the object name specified in 
this routine. 

Every element must be linked to at least one object 
inorder for it to be displayed on the vector general 
screen. A user can link one or more element names to 
an object. Elements can be linked to an object by one 
or several calls to this routine. An element can be 
linked to several different objects» or one element 
may be linked several times to the same object. 

If an object or element has been erased from the 
display screen^ a user can redisplay the desired ob- 
ject or elements by again establishing the desired 
ob j ec t -e 1 ement association. 

num specifies the number of element names being passed 
in this routine^ num can vary between 1 and 10, 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOS - Unknown object name. 

Error - E06 - Unknown element name. 

Error - EOS - Number of elements allowed 
Per picture exceeded. 

Error - E09 - Maximum number of objects 

allowed per picture (10) exceeded, 

ALSO SEE: 

drawele^ copyele 
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remove 



remove 



NAME: 



remove • erase the indicated portion of the picture 
and remove the associated elements from 
memory 

SYNOPSIS: 

Parameter values: 

PIC / 00 

To remove the entire picture: 
remove(PIC); 

To remove element structures : 

remove (num, "el el ” t "el e2" > . . ) ; 
int num; 

DESCRIPTION: 

The entire picture# or every occurrence of the named 
elements are erased from the vector general display 
screen. Each name element structure will be removed 
from memory. 

To redisplay any portion of the removed picture re- 
quires that the user rebuild each element and relink 
it to the appropriate objects. 

num specifies the number of element names being passed 
in this rout i ne . 

DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOS - Unknown object name. 

Error - E06 - Unknown element name. 

Error - E18 - Value num not between 1-10. 

Error - E21 - Element not associateo with 
the named object. 

ALSO SEE: 

erase 
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rotate 



rotate 



NAME; 



rotate - rotate an object 



SYNOPSIS: 

rotate("objname"fXradians»yradians t^zradiansl ); 
float X radi ans » y rad i ans [»zradiansJ } 



DESCRIPTION: 

The named object will be rotated about the y, z 
coordinate axis. The parameters^ given in radian meas- 
urer specify the degree of rotation desired about each 
axis. 

The z parameter is reguired only when the coordinate 
system is defined as three dimensional and will be 
ignored otherwise. 



DIAGNOSTICS; 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOS - Unknown object name. 
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scale 



scale 



NAME; 



scale - modify object scale 



SYNOPSIS: 

sea 1 e ( "ob j name” / scale)? 
f 1 oat scale? 



DESCRIPTION: 

All elements associated with the named object 
scaled by the value scale at display time. The 
of scale is from zero to one. If not established 
user this value automatically defaults to one» 
is the maximum picture scale. 



DIAGNOSTICS; 

All error messaaes will be printed on the PDP-11 
minal screen. 

Error - £05 - Unknown object name. 



a re 
range 
by a 
which 



t e r- 
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I 



set vec tor 



set vector 



NAME: 



setvector • specify the vector type and vector mode 



SYNOPSIS: 

set vec t or ( V t ype » vmode [»incl [#scalel )? 



vtype : 



VR - 
VRX - 
VRY - 
VRZ - 
VA - 
VAX - 
VAY - 
VAZ - 
INC2 - 
INCX - 
INCY - 
INC3 - 



vector 
vector 
vector 
vector 
vec tor 
vec tor 
vector 
vec tor 
vector 
vector 
vector 
vec tor 



relative 
relative auto 
relative auto 
relative auto 
absol ut e 
absolute auto 
absolute auto 
absolute auto 
incremental 
i nc rement a 1 
i nc remen t a 1 
i nc rement a 1 



•increment x 
-increment y 
-increment z 

-increment x 
- i nc remen t y 
-increment z 

2- d i mens i ona 1 
aut o” i nc rement 
aut o-i nc rement 

3- dimensional 



vmode : 



seal e: 



LN / 00-1 



OSH / 020 - 
DOT / oao - 
PNT / 060 - 
DO /0120 - 
ODD /OUO - 



1 ne 

dashed 1 i ne 
dotted 1 i ne 
end point 
dash-dot -dash 
dash-dot -dash 



1 ne 
i ne 



MG / 000 - 



NMG /0200 - 



add the coordinate increments 
to the high order bits of the 
specified register, 
add the coordinate increments 
to the low order bits of the 
specified register. 



float i nc ; 



DESCRIPTION: 

This routine specifies which one of the 12 vector 
types is to be drawn in the line# mover circle and arc 
instructions which follow. It also specifies the vec- 
tor mode (i.e.f liner dottedr dashedr etc.)r and if 
requiredr the increment value for au t o- i nc rement vec- 
tors and the scale factor for incremental vectors. 
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set vec tor 



set vec tor 



The coordinate values passed in the following draw 
instructions are dependent on the vector type selected 
in this rout i ne . 

This must follow a drawele call and preced any draw 
instructions. This routine can be called any number of 
times within a draw element block. 

The bracketed z parameters are required only when the 
coordinate system has been defined as three dimension- 
al . 



DIAGNOSTICS: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



E r ro r 


- 


EOl 


Error 


- 


E02 


E r ro r 


• 


E13 


E r ro r 


- 


E15 


E r ro r 


- 


E16 


Error 


- 


E17 


E r r 0 r 


- 


E19 



This routine has been called outside 
of a draw element block. 

The space allocated for the building 
of elements has been exceeded. 

Vector type undefined. 

The X value was out of bounds. 

The y value was out of bounds. 

The z value was out of bounds. 

Illegal arc/circle instruction 
from an incremental vector. 
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set vector 



VA 



set vec tor 



VA 



NAME: 



VA - vector absolute 
SYNOPSIS: 

drawele("e)ename’') ! 



setvector(VA,vmode) ; 

move (coo rdx f coo rdy (rcoordzl ); 

H ne (coordx f coordy tfcoordz) ); 

c i rc 1 e ( d i r f cen t X f c en t y (»centzJ )J 

arc (di r f cent X , cent y ( f cent zl / endx , endy (fendzl); 



ende 1 e ( ) J 

float coordx f coordy IfCoordz] ! 

float centXfCenty [ / c en t zl ^ endx ^ endy (rendzl; 



DESCRIPTION; 

The X f y f z coordinates of absolute vectors are speci- 
fied with respect to the origin, or zero position of 
the user defined coordinate system. Each x, y, z coor- 
dinate value references a unique point on the display 
screen. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 



of 


e 1 ement s 


has 


been 


exceeded 


Error - E13 - Vecto 


r t ype 


unde fined. 




Error - E15 - The 


X 


va 1 ue 


was 


out 


of 


bounds 


Error - E16 - The 


y 


value 


was 


out 


of 


bounds 


Error - E17 - The 


z 


va 1 ue 


was 


out 


of 


bounds 



loa 



set vector 



VAX 



setvector -VAX 



NAKE: 



VAX - vector absolute aut o” i nc retnen t x 
SYNOPSIS: 

drawele("elename")f 



setvector(VAX,vmodefXinc); 

moveCcoordy t^coordzl )? 

move(coordy IfCoordzJ )? 

c i rc 1 e ( di r f cent y IfCentzl )? 

arc (di r f cent y [ r cent zl ^ endy (^endzl); 



ende 1 e ( ) ? 

float xinCf coordy (fCOordzl ; 
float centy C f cent zl f endy l/endzl; 



DESCRIPTION: 

The vector absolute auto-increment x causes the ini- 
tial X coordinate value to be incremented or decre- 
mented by the value specified by xinc. With every 
move^ line/ arCf or circle command the specified y and 
z coordinate values are updated while the x coordinate 
value is stepped by the constant value xinc. For 

examplef the pointfxr yr z) becomes po i n t ( x x i nc / 
coordy f coordz ) . 

The value of xinc cannot exceed the ranqe of the de- 
fined coordinate system. 



DIAGNOSTICS: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Er ror - EO 1 

Error - £02 

Error - E13 
Error - ElA 

Error - E16 
Error - E17 



This routine has been called outside 
of a draw element block. 

The space allocated for the building 
of elements has been exceeded. 

Vector type undefined. 

The increment value was out of 
bounds . 

The y value was out of bounds. 

The z value was out of bounds. 
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set vec top 



VAY 



set vector 



VAY 



NAME: 



VAY - vector absolute au t o- i nc remen t y 
SYNOPSIS: 

draweleCelename")/ 



setvectorfVAYfvmodefyinc); 

move(coordx (^coordzl )? 

line(coordx (fCoordzJ ); 

c i rc 1 e (di r f cent X t/centzJ )? 

arc (di r/cent X t » cent zl » endx (fendzl); 



ende 1 e ( ) / 

float yinc/coordx tfCoordzl i 
float centx { f cent zl > endx [fendzJ? 



DESCRIPTION; 

The vector absolute auto-increment y causes the ini- 
tial y coordinate value to be incremented or decre- 
mented by the value specified by yinc. With every 
move^ line/ arc or circle command the specified x and 
z coordinate values are updated while the y coordinate 
value is stepped by the constant value yinc. For 
example/ the point(x/y/z) becomes po i n t ( coo rdx / y +y i nc / 
coo rdz ) . 

The value of yinc cannot exceed the range of the de- 
fined coordinate system. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - El^l - The increment value was out of 
bounds . 

Error - E15 - The x value was out of bounds. 

Error - E17 - The z value was out of bounds. 
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set vec tor 



VAZ 



setvector - VAZ 



NAME: 



VAZ - vector absolute au t o- i nc remen t z 
SYNOPSIS: 

drawele("elename")? 



setvector(VAZfvmode/Zinc): 

move(coordxfCoordy); 

1 ine(coordxfcoordy); 

ci rc1e(di r»centxrcenty) » 

arc(dirfCentXfCentyfendxzendy); 



ende 1 e ( ) ? 

float zincfcoordxfcoordy; 
float cen t X f cent y » endx ^ endy ; 



DESCRIPTION: 

The vector absolute auto" increment z causes the ini* 
tial z coordinate value to be incremented or decre- 
mented by the value specified by zinc. With every 
mover liner arc or circle command the specified x and 
y coordinate values are updated while the z coordinate 
value is stepped by the constant value zinc. For 
example the point(xrVrz) becomes poi nt ( coo rdx r coordy r z 
♦zinc). 

The value of zinc cannot exceed the ranoe of the de- 
fined coordinate system. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - EOS - The space allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - E14 - The increment value was out of 
bounds . 

Error - E15 - The x value was out of bounds. 

Error - E16 - The y value was out of bounds. 
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set vec tor 



VR 



setvector 



VR 



\ 



NAME: VR - vector relative 
SYNOPSIS: 

drawele("elename"); 



setvector(VR^vmode) 7 

mo ve ( de 1 t ax / de 1 t ay [fdeltazl )? 

1 ine(del tax»del tay t^deltazl )7 
circ1e(dir»centxrcenty» (centzl ); 
arc(dir,centx,centy(fCentz3 fendx,endytfendz] )* 



ende 1 e ( ) 7 

float de 1 t ax » de 1 t ay t»deltazl 7 

float centXfCenty ( » cent zl » endx , endy {»endzl7 



DESCRIPTION: 

Relative vectors specify a increment value that is to 
be added to or subtracted from the initial x,ytz abso- 
lute coordinate values. For example^ the point(x»y»z) 
becomes po i n t ( x +de 1 t ax r y +de 1 t ay r z +de 1 t a z ) . 

The parameter values cannot exceed the range of the 
defined coordinate system. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal sc reen . 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements hafe been exceeded. 

Error - E13 - Vector type undefined. 



Error - E15 - The 


X 


value 


was 


out 


of 


bounds 


Error - E 1 6 - The 


y 


value 


was 


out 


of 


bounds 


Error - E17 - The 


z 


value 


was 


out 


of 


bounds 
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setvector 



VRX 



set vec tor 



VRX 



NAME: 



VRX - vector relative aut o- i nc rement x 



SYNOPSIS: 

drawele("e1ename"); 



setvector(VRX/vmode/xinc) 
move(de1tay (/deltazl )? 

1ine(deltay t^deltazJ ); 

ci rcl e(di r/centy (/centzl); 

a rc (d i r f cen t y [ ^ cent zl » endy l/endzl)? 



ende 1 e ( ) ? 

float xincfdeltay IrdeltazJ } 
float centy [ f cent zl / endy [#endz]/ 



DESCRIPTION: 

A vector relative auto-increment x causes the initial 
X coordinate value to be incremented or decremented by 
the constant value xinc. With every move/ line/ arc 
or circle instruction that follows/ the y and z coor- 
dinate values will' be updated/ while x is stepped by 
the value xinc. For example/ the point(x/y/Z) becomes 
point (xtxi nc/y + del tay/Ztdel taz) . 

The parameter values cannot exceed the range of the 
defined coordinate system. 



DIAGNOSTICS: 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Er ror 


- 


EOl 


E r ro r 


- 


E02 


Error 




E13 


E r ror 


— 


E19 


E r ro r 


- 


E16 


E r ro r 


- 


E17 



This routine has been called outside 
of a draw element block. 

The space allocated for the building 
of elements has been exceeded. 

Vector type undefined. 

The increment value was out of 
bounds . 

The y value was out of bounds. 

The z value was out of bounds. 
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setvec^tor - VRY 



setvector 



VRY 



NAME: 



VRY - vector relative auto-increment y 
SYNOPSIS: 

drawe1e("elename"): 



setvector(VRY,vmode»yinc) 

move(deltax (rdeltazl ); 

line(deltax (/deltazJ ); 

c i rc 1 e (di r f cent X [,centz3); 

arc (di recent X t » cent zl » endx t»endzl)? 



ende 1 e ( ) » 

float yinc/deltax [^deltazl } 
float centx [ » cent zl » endx [»endzl: 



DESCRIPTION: 

A vector relative auto-increment y causes the initial 
y coordinate value to be incremented or decremented by 
the constant value yinc. With every move# line» arc 
or circle instruction that follows^ the x and z coor- 
dinate values will be uodated» while y is stepped by 
the value yinc. For example^ the point(x,y,z) becomes 
point (x + del tax»y + yinc» z+del taz) . 

The parameter values cannot exceed the range of the 
defined coordinate system. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - El^ - The increment value was out of 
bounds , 

Error - E15 - The x value was out of bounds. 

Error - E17 - The z value was out of bounds. 
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setvector - VRZ 



setvectop - VRZ 



NAME: 



VRZ - vector relative aut o- i nc remen t z 
SYNOPSIS: 

drawele("elename ") f 



setvector(VRZfvmodefZinc) 
move(deltaxf deltay)? 
Hne(de1tax ^deltay)? 
ci rcle(di r^centx^centy) ; 
arc(di rfCentXfCenty^endXfendy): 



ende 1 e ( ) ; 

float 2 i nc / de 1 t ax » de 1 t ay ? 
float cent X » cent y f endx f endy ; 



DESCRIPTION: 

A vector relative auto-increment z causes the initial 
z coordinate value to be incremented or decremented by 
the constant value zinc. With every move» line^ arc 
or circle instruction that follows^ the x and y coor- 
dinate values will be updated/ while z is stepped by 
the value zinc. For example/ the point(x/y/z) becomes 
point (x+del tax/y + del tay/Z + incz) . 

The parameter values cannot exceed the range of the 
defined coordinate system. 



DIAGNOSTICS; 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - El^l - The increment value was out of 
bounds . 

Error - E15 - The x value was out of bounds. 

Error - E16 - The y value was out of bounds. 
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setvector - INC2 



setvector 



INC2 



NAME: 



INC2 - incremental vector > two dimensional 
SYNOPSIS: 



drawele("elename")? 



setvector(INC2fvmode^scale)? 
move(del taxfdel tay ) ! 

1 ine(del taxfdel tay); 



ende 1 e ( ) ? 

float de 1 t ax f de 1 t ay ; 
scale: 

MG - add the coordinate increments to the 7 

high order bits of the specified register, 
NMG- add the coordinate increments to the 7 

low order bits of the specified register. 



DESCRIPTION: 

A two dimensional relative vector^ that halves vector 
storage reguirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage regui rement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruc- 
tions are limited to approximately 3% of the user 
minimum and maximum coordinate ranges. The parameter^ 
scales specifies if this increment value should be 
added to the 7 high order bits of the specified coor- 
dinate or to the 7 low order bits. This scale factor 
then determines if the increments will be applied over 
a fine(NMG) or coarse(MG) grid. 

Arcs and circles cannot be drawn with this vector 
type. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOl - This routine has been called outside 
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setvector 



- INC2 



setvector - INC2 



of a draw element block. 

Error - E02 - The space allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - E15 - The x value was out of bounds. 

Error • E16 - The y value was out of bounds. 

Error - E19 - Illegal arc/circle instruction 

from an incremental vector. 
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setvector - INCX 



setvectop - INCX 



NAME; 



INCX - incremental vector ^two dimensional 
auto”i ncrement x 



SYNOPSIS; 

drawe1e("elename ") ! 



setvectorCINCXfvmodefxinCfScal e) » 
move(de1 tay/del tay ) f 
1 ine(deltayfdeltay); 



ende 1 e ( ) / 

float X i nc / del t ay ; 
scale; 

MG - add the coordinate increments to the 7 

high order bits of the specified register, 
NMG- add the coordinate increments to the 7 

low order bits of the specified register. 



DESCRIPTION; 

A two dimensional relative vector^ that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruc- 
tions are limited to apo rox i mat e 1 y 3% of the user 
minimum and maximum coordinate ranges. The parameter/ 
scale/ specifies if this increment value should be 
added to the 7 high order bits of the specified coor- 
dinate or to the 7 low order bits. This scale factor 
then determines if the increments will be applied over 
a fine(NMG) or coarse(MG) grid. 

This incremental/ auto increment vector causes the x 
coordinate value to be incremented or decremented by 
the constant value xinc/ while the y coordinate value 
is increment by small relative values. 

Arcs and circles cannot be drawn with this vector 
type. 



1 la 



i 



setvector - INCX 



set vec tor 



INCX 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - £01 - This routine has been called outside 
of a draw element block. 

Error - E02 - The soace allocated for the building 
of elements has been exceeded. 

Error - E13 - Vector type undefined. 

Error - El^ - The increment value was out of 
bounds , 

Error - E16 - The y value was out of bounds. 

Error - E19 - Illegal arc/circle instruction 
from ah incremental vector. 
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set vector 



INCY 



setvector - INCY 



NAME; 

INCY - incremental vector »two dimensional 
aut o* i nc rement y 



SYNOPSIS: 

drawele("elename") ? 



setvector(INCY,vmodefyinc»scale)f 

move(deltax/deltax); 

1 ine(deltax/del tax); 



ende 1 e ( ) ; 

float yincrdeltax; 
scale: 

MG - add the coordinate increments to the 7 

high order bits of the specified register. 
NMG- add the coordinate increments to the 7 

low order bits of the specified register. 



DESCRIPTION: 

A two dimensional relative vector^ that halves vector 
storage requirements and doubles the data rate. This 
vector type should be used when element storage space 
is critical. This reduced storage requirement results 
from a limitation on the maximum size of each relative 
increment. The values passed in line or move instruc” 
tions are limited to aop rox i mat e 1 y 3% of the user 
minimum and maximum coordinate ranges. The parameterf 
scales soecifies if this increment value should be 
added to the 7 high order bits of the specified coor- 
dinate or to the 7 low order bits. This scale factor 
then determines if the increments will be applied over 
a fine(NMG) or coarse(MG) grid. 

This incrementalf auto increment vector causes the v 
coordinate value to be incremented or decremented by 
the constant value xinc» while the y coordinate value 
is increment by small relative values. 

Arcs and circles cannot be drawn with this vector 
type . 
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set vec top 



INCY 



setvector 



INCY 



DIAGNOSTICS; 



All error messages will be printed on the PDP-11 ter- 
minal screen. 



Error - EOl 

Error - E02 

Error - E13 
Error - El^ 

Error - E15 
Error - E19 



This routine has been called outside 
of a draw element block. 

The space allocated for the building 
of elements has been exceeded. 

Vector type undefined. 

The increment value was out of 
bounds . 

The X value was out of bounds. 
Illegal arc/circle instruction 
from an incremental vector. 
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setvector - INC3 



set vec top 



INC3 



NAME; 



INC3 • incremental vector ^three dimensional 



SYNOPSIS: 

draweleCelename”); 



setvector (INCXf vmodCf scale)? 
move(deltax,deltavfdeltaz); 

1 ine(del tax/deltay^del taz)? 



ende 1 e ( ) ? 

float de 1 t ax r de 1 t ay f de 1 t az ? 
scale; 

MG - add the coordinate increments to the 7 

high order bits of the soecified register. 
NMG- add the coordinate increments to the 7 

low order bits of the specified register. 



DESCRIPTION: 

A three dimensional relative vector^ that halves vec- 
tor storage requirements and doubles the data rate. 
This vector type should be used when element storage 
space is critical. This reduced storage requirement 
results from a limitation on the maximum size of each 
relative increment. The values passed in line or move 
instructions are limited to approximately 3% of the 
user minimum and maximum coordinate ranges. The 
paramater, scaler specifies if this increment value 
should be added to the 7 high order bits of the speci- 
fied coordinate or to the 7 low order bits. This 
scale factor then determines if the increments will be 
applied over a fine(NMG) or coarse(MG) grid. 

Arcs and circles cannot be drawn with this vector 
type. 



DIAGNOSTICS; 

All error messages will be printed on the PDP-11 ter- 
minal screen. 
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setvectop - INC3 



set vector 



INC3 



E r ro r 


- 


EOl 


E r ro r 


- 


E02 


Error 


- 


E13 


Error 


- 


E15 


Error 


- 


E16 


Error 


- 


E17 


Er ror 


- 


E19 



This routine has been called outside 
of a draw element block. 

The soace allocated for the building 
of elements has been exceeded. 

Vector type undefined. 

The X value was out of bounds. 

The y value was out of bounds. 

The z value was out of bounds. 

Illegal arc/circle instruction 
from an incremental vector. 
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sys i n i t 



sy s i n i t 



NAME: 



sysinit - vector general display initialization 



SYNOPSIS: 

sys i ni t ( ) ? 



DESCRIPTION: 

This routine establishes a link with the vector gen- 
erals initializes its display system and sets all the 
user default parameters. 

This routine must be called before any other display 
i nst ruct ions. 



DIAGNOSTICS: 

If the initialization cannot be properly completed^ an 
error message will be printed on the PDP-11 terminal 
and the process will be terminated. This error could 
occur because the vector general is being accessed by 
a another user. 
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t rans 



t rans 



NAME: 



trans - translate object 



SYNOPSIS; 

t rans ( "ob j name" f X » y l#zl )? 
float XfY l,z) ; 



DESCRIPTION: 

All of the elements associated wfth the named object 
are translated by the amount x» y» z at display time. 
Each coordinate point(X»Y,Z) of the object becomes 
point (X+x»Y+y»Z+z) at display time. 

The z parameter is required only when the coordinate 
system is defined as three dimensional^ and will be 
ignored if included. 



DIAGNOSTICS: 

All error messages will be printed on the PDP-11 ter- 
minal screen. 

Error - EOS - Unknown object name. 
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